home *** CD-ROM | disk | FTP | other *** search
/ More DosGames 2.0 / MORE - Dosgames 2.0 (Software Company)(1994).iso / dosgames / mille / function.lst next >
File List  |  1994-09-01  |  19KB  |  466 lines

  1.  
  2.         TEGL WINDOWS TOOLKIT FUNCTION SUMMARY:
  3.  
  4. TEGL Easy
  5. ---------
  6. activebutton        - make a button/frame
  7. coltox            - calculate the X coordinate for a text column
  8. errmess         - display an error message
  9. fitframe        - create coordinates to fit on the screen
  10. frame/fromicon        - open a frame in an event called from an icon
  11. frametext        - write text to a frame using row, column
  12.               coordinates simulating text mode
  13. getmousey        - return mouse click number after a mouse click
  14. getyesno        - get a yes or no response
  15. easytegl        - do a simplified startup for the toolkit
  16. lastcol         - returns last column of a frame as if in text mode
  17. lastrow         - returns last row of a frame as if in text mode
  18. outframetextxy        - write text to frame using relative coordinates
  19. quit            - halt program
  20. quickframe        - push an image and clear the frame
  21. restoretext        - restore the current font
  22. rowtoy            - calculate the Y coordinate for a text row
  23. selecteasytext        - change to the font set by seteasyfont
  24. seteasyfont        - set font used by the TEGL Easy Unit
  25.  
  26. Frames
  27. ------
  28. countframes        - return the number of frames currently on the stack
  29. frameexist        - determine if a frame is on the frame stack
  30. pushimage        - save a background image before clearing and
  31.               drawing new images in this area
  32. popimage        - restore the top background image after a PushImage
  33. rotatestackimage    - rotate a frame forward or backward relative to
  34.               frames on the screen
  35. rotateunderstockimage    - rotate a frame below frame2
  36. dropstackimage        - close a frame that is not the topmost image on
  37.               the stack
  38. hideimage        - hide an Image Frame from the screen but retain
  39.               the current stack position
  40.               and frontal image
  41. showimage        - show a Hidden Image Frame
  42. showcoordinates     - an Event that displays the coordinates of a frame
  43. prepareforpartialupdate - prepare a portion of a frame for output
  44. prepareforupdate    - prepare a frame for output
  45. commitupdate        - commit update
  46. frameselectandmove    - allow a frame to be moved
  47. setautorotate        - set the frame stack auto rotate function
  48. setmoverestrictions    - set limits to move a frame
  49. setframemobility    - toggle the ability for a frame to move
  50. setmoveframecallproc    - call an event process after a frame has been
  51.               dragged to a new screen position
  52. movestackimage        - move a frame to a new screen location
  53. moveframe        - move an X or wire frame
  54. unlinkfs        - disconnect a frame from the stack
  55. linkfs            - reconnect a frame to the stack
  56. linkunderfs        - reconnect a frame with the frame stack, below
  57.               the specified frame
  58. createimagebuffer    - allocate an Image buffer (frame) on the heap
  59. dropimagebuffer     - free the memory used by the frame on the heap
  60. getfsimage        - retrieve the screen image within a stacked frame
  61. putfsimage        - place the frame saved image anywhere on the screen
  62. freeimagebuffer     - free up the memory allocated for a frame buffer
  63. getpartialfrontimage    - get partial image of a frame and return a pointer
  64.               to a temporary buffer
  65. getfrontimage        - get image of a frame and return a pointer to a
  66.               temporary buffer
  67. pageinfs        - read an image into memory
  68. lockimage        - lock a frame image into memory
  69.  
  70. pageoutfs        - page out a frame image
  71. setimagecoordinates    - set the frame pointer to a new set of coordinates
  72. pageoutimagestack    - request the virtual memory manager to page out images
  73. unlockimage        - unlock a frame image
  74. unuseimage        - flag a frame image as no longer in use
  75. useimage        - make an image available for use
  76.  
  77. Mouse Click Areas
  78. -----------------
  79. definemouseclickarea    - attach a sensitive area of a frame to an event function
  80. findmouseclickptr    - search for a Mouse Click Pointer associated with
  81.               a Mouse Click Number
  82. resetmsclickactive    - reset the active flag to indicate if a mouse
  83.               click area is active or inactive
  84. resetmsclickcallproc    - change the Event Handler for a mouse click to
  85.               another Event Handler
  86. resetmouseclicks    - remove a chain of mouse clicks from a frame
  87. resetmsclicksense    - reset the sense parameter associated with a
  88.               mouse click area
  89.  
  90. Keyboard
  91. --------
  92. clearkeyboardbuf    - clear the hardware keyboard buffer
  93. clearteglkeyboardbuf    - clear the software buffer maintained by the Toolkit
  94. defineglobalkeyclickarea- flexible keycode assignment
  95. definelocalkeyclickarea - assign a keycode to a frame and mouse click area
  96. dropkeyclick        - remove a key trap
  97. findkeyclickptr     - locate a key assignment
  98. resetkeyclickcallproc    - change the callproc a key is assigned to
  99.  
  100. Menus
  101. -----
  102. createoptionmenu    - create an option menu header
  103. defineoptions        - add option entries to an option menu
  104. createshadowom        - create a duplicate option menu header with a
  105.               different font type
  106. resizeoptionmenu    - recalculate the size of the option menu window
  107.               when changing the font type
  108. togglecheckmark     - change the first character of an entry string
  109. toggleentrystatus    - set an option entry to active or not active
  110. replaceoptiontext    - replace option entry string by another text
  111.               string
  112. toggleoptionbar     - invert mouse click areas
  113. setoptionmenucolors    - change the menu entry colors
  114. setoptionmenubordercolor- change the colour of the option menu border
  115. sethidesubmenu        - toggle the hiding of sub menus
  116.  
  117. Bar Menu
  118. --------
  119. createbarmenu        - create a bar window frame
  120. outbaroption        - attach an option menu (list) to a displayed
  121.               text string on the bar
  122. setbartextcolor     - change the default text color on the bar
  123. setbarmenucolor     - change the bar color
  124. setbarbordercolor    - change the bar border color and toggle the
  125.               border on
  126. setbarborderoff     - toggle the bar border off
  127. setbarshadowtext    - toggle bar shadow text on/off
  128. setbarfillstyle     - set the bar fill style
  129. setbarmenumargin    - set the left margin on the barmenu
  130.  
  131. Icon Option Menu
  132. ----------------
  133. defineoptionclickarea    - attach an option menu (list) to a frame on icon area
  134. resetoptionmenuevents    - eliminate duplicate menu events where the frame
  135.               has been closed
  136.  
  137. Interrupt Handlers
  138. ------------------
  139. swapteglintroff     - restore all interrupts to the original saved vectors
  140. swapteglintron        - save and initialize the required TEGL interrupts
  141.  
  142.  
  143. Mouse Emulation
  144. ---------------
  145. mcursoroff        - switch the emulated mouse cursor off
  146. mcursoron        - switch the emulated mouse cursor on
  147. msetpos         - set a new position for the emulated mouse cursor
  148.  
  149. Standard Mouse Functions
  150. ------------------------
  151. showmouse        - display a mouse cursor at current mouse x,y coordinates
  152. hidemouse        - hide mouse cursor
  153. setmouseposition    - set x,y coordinates of mouse cursor
  154. cursorshape        - set the mouse cursor shape
  155. setmousehotspot     - set the cursor hot-spot values
  156. setmousecolor        - set the mouse cursor color
  157. mouseposition        - get the mouse cursor coordinates and button information
  158. getbuttonreleaseinfo    - get the mouse cursor release information
  159. getbuttonpressinfo    - get the mouse cursor button press information
  160. clearbuttoninfo     - clear the mouse button info counters
  161. setmouseminmax        - set the mouse cursor minimum and maximum coordinates
  162. frozenmouse        - prevent the mouse from moving when updating the screen
  163. freezemouse        - prevent the mouse from moving or being overwritten
  164.               when updating the screen
  165.  
  166. unfreezemouse        - release the mouse from a frozen or freeze status
  167. setmousesensitivity    - set the mouse-to-cursor movement sensitivity
  168. getmousesensitivity    - return the mouse-to-cursor movement sensitivity
  169.               scaling factors previously set
  170. setkeyboardmouse    - toggle the keyboard mouse on or off
  171. setkbsteps        - set the amount of pixel movement with each cursor
  172.               key press
  173. getkbsteps        - return the pixel movement value set for the
  174.               keyboard mouse
  175.  
  176. Timer Functions
  177. ---------------
  178. swaptimerout        - restore the original timer vectors
  179. swaptimerin        - capture the original timer vectors and set interrupt
  180.               vectors to point TEGL's timer function
  181. settimerstart        - set the timer value of timepiece counter
  182. resettimerflag        - reset the flag that indicates the completion
  183.               of a cycle
  184. droptimercount        - delete a timepiece record from the timer event chain
  185. timerswitch        - toggles the timer handler on or off
  186.  
  187. Keyboard Interrupt Events
  188. -------------------------
  189. addcapturekey        - add a keyboard scan code to the keyboard
  190.               handler for capturing
  191. deletecapturekey    - remove a keyboard scan code from the keyboard
  192.               scan code chain
  193. teglreadkey        - read a scan code from the TEGL keyboard buffer
  194. teglkeypressed        - return True if a scan code is captured, False otherwise
  195. nilkeycallproc        - dummy function to use a place holder
  196.  
  197. Keyboard Miscellaneous
  198. ----------------------
  199. setshiftkeys        - toggle the shift flags on/off
  200.  
  201. Show Button Status
  202. showbuttonstatus    - event that displays the mouse button status
  203.  
  204.  
  205. Assembler Graphics
  206. ------------------
  207.  
  208. Setting Video Modes
  209. -------------------
  210. videoautodetect     - auto detects and switches to CGA, Hercules, EGA and VGA
  211. cga640x320x2        - set the video mode to CGA 640 x 200 in 2 colours
  212. herc720x348x2        - set the video mode to Hercules 720 x 348 in 2 colours
  213. ega640x350x16        - set the video mode to EGA 640 x 350 in 16 colours
  214. vga640x480x16        - set the video mode to VGA 640 x 480 in 16 colours
  215. svga800x600x16        - set the video mode to SVGA 800 x 600 in 16 colours
  216.  
  217.  
  218. Graphic Primitives
  219. ------------------
  220. fastline        - draw a line from (x,y) to (x1,y2)
  221. putpixs         - plot a pixel
  222. getpixs         - return the pixel value at x,y
  223. getbiti         - copy the specified screen image into a buffer
  224. putbiti         - copy the buffer to the specified screen area
  225. bigimagesize        - calculate the size of the image buffer
  226. setapage        - set the active page for graphics output
  227. setvpage        - set the visual graphics page number
  228. flipapage        - flip the active page to the alternate page
  229. flipvpage        - flip the visual page to the alternate page
  230. videopage        - return the current visual page
  231.  
  232. New Graphic Primitives
  233. ----------------------
  234. extractpixs        - return the pixel value at x,y within an image buffer
  235. extractimg        - extract an image area from a buffer
  236. overlayimg        - overlay buffered image
  237. swapbytes        - swap two buffers
  238.  
  239. Graphic Derivatives
  240. -------------------
  241. xorcornerbox        - create box corners only
  242. xorbox            - draw a (xor) rectangle
  243.  
  244. Icon Graphics
  245. -------------
  246. putpict         - put an icon to a specified screen area
  247. pictsize        - get the width and height in pixels of an icon image
  248. abortmsg        - close the graphics systems and display the
  249.               message string
  250.  
  251. Special Effects
  252. ---------------
  253.  
  254. Screen Backdrop
  255. ---------------
  256. clearteglscreen     - clear the screen to the backdrop pattern
  257. setteglbordershow    - set switch to draw/not draw a border after the
  258.               bar fill
  259. setteglbackcolor    - set the color of the backdrop
  260. setteglbordercolor    - set the border color of the backdrop
  261. setteglfillpattern    - set the fill pattern for the backdrop
  262. setteglfillstyle    - set the fill style for the backdrop
  263.  
  264. Shadow Boxes
  265. ------------
  266. shadowbox        - create a 3-D box
  267. shadowboxtext        - output a text string within a shadowbox
  268. setshadowcolor        - set the bar fill color
  269. setshadowbordercolor    - set the shadowbox border color
  270. setshadowfillpattern    - set bar fill pattern for shadowbox
  271. setshadowfillstyle    - set bar fill style for shadowbox
  272.  
  273. Creating Shadow Text
  274. --------------------
  275. shadowtext        - display a shadowed textstr at (x,y)
  276. setshadowtexttype    - set the shadow text font type
  277. setshadowtextshadow    - set the shadow color for shadowtext
  278. setshadowtexthighlight    - set the highlighted color for shadowtext
  279. shadowtexthighlightoff    - reset the highlight color set by
  280.               setshadowtexthighlight
  281.  
  282. Other Text Effects
  283. ------------------
  284. extendtextxy        - make embossed text
  285. shifttexttxy        - write text with a leading white edge
  286.  
  287. Buttons
  288. -------
  289. definebuttonclick    - display icon, set mouse click area and attach
  290.               it to an event
  291. definelongbuttonclick    - display a long button with text, set mouse click
  292.               area and attach it to an event
  293. defineuserbuttonclick    - display a button with text, set mouse click area,
  294.               and attach it to an event
  295. putuserbuttonclick    - draw a button at the coordinates with a message
  296.  
  297. Explosions
  298. ----------
  299. collapsetoiconshow    - collapse a frame, restore icon it came from
  300. collapsetomsclick    - collapse a frame, zip back to original mouse
  301.               click position
  302. explodefromiconhide    - hide icon, zip and open a new frame
  303. explodefrommsclick    - zip from a mouse click location to a new frame
  304.               position
  305.  
  306. Boxes
  307. -----
  308. movebox         - move a (xor) frame
  309. ziptobox        - create a moving or expanding (xor) wire frame
  310. zipfrombox        - create a shrinking and moving (xor) wire frame
  311.  
  312. Icon Button
  313. -----------
  314. drawlongbutton        - create an icon button if size ln at (x,y)
  315.  
  316. Writing Events
  317. --------------
  318. Mouse Awareness
  319. ---------------
  320. findframe        - search through frame stack for the first frame
  321.               that overlaps the coordinates passed as a parameter
  322. checkmouseclickpos    - compare all mouse click defines within a frame
  323.               for a notch with the current mouse coordinates
  324. checkformouseselect    - check if one of the mouse click areas within a
  325.               frame has been selected
  326.  
  327. Special Effects
  328. ---------------
  329. pressbutton        - simulate the passing of a button type icon
  330. visualbuttonpress    - perform the pressing and releasing of a button
  331.               type icon
  332.  
  333. Animation
  334. ---------
  335. origin procedure    - set the animated object's starting origin
  336. getorigin        - get the animated object's current coordinates
  337. destination        - return a count on the number of frames needed
  338.               for animating
  339. resetframe        - reset a sequence to begin at any frame number
  340. sequence        - set the sequence pointer
  341. resetsequence        - set the internal data pointers firstframe and
  342.               curentframe to nil
  343. addframe        - add an animation frame
  344. currentframenumber    - return the current frame number
  345. animateinit        - replicate the first active screen page to the
  346.               second to prepare for animating
  347. animate         - begin the animation sequence
  348. animatecomplete     - close the animation sequence
  349.  
  350. Writing Text
  351. ------------
  352. fmttegltextxy        - write formatted output to the graphics screen
  353. outtegltextxy        - write mystr to the graphics screen at x,y
  354. tegltextwidth        - return the proportional width of mystr
  355. teglcharwidth        - return the proportional width of a character
  356. teglcharheight        - return the height of the proportional font
  357. teglwrtchar        - write a single character to the graphics screen
  358. setproportional     - switch proportional font on or off
  359. setteglfont        - set the font to use in subsequent calls to outtegltextxy
  360. fontname        - return the name of a font
  361. showonefont        - event that displays a font based on
  362.               mouseclickpos>clicknumber
  363. showfonts        - event that displays all fonts
  364.  
  365. Events Library
  366. --------------
  367. selectafile        - provide a file selection dialogue to choose or
  368.               create a new filename
  369. editstring        - provide a string input facility
  370. setmousesense        - provide a mouse sensitivity dialogue window to
  371.               change sensitivity setting of the mouse
  372.  
  373. Sound Unit
  374. ----------
  375. asksoundsense        - sound duration dialogue event
  376. beep            - toggle sound on for a specific tone and duration
  377. slidebeep        - perform a sliding type of sound
  378. soundswitch        - switch the sound function on/off
  379.  
  380. Virtual Memory Manager
  381. ----------------------
  382. cgetmem         - return a pointer to a memory block of the specified size
  383. cfreemem        - free a memory block and return memory back to heap manager
  384.  
  385. Expanded Memory
  386. ---------------
  387. emminstalled        - return an installed status on expanded memory manager
  388. emspagesavailable    - gets total number of expanded memory pages and
  389.               number of those pages not already allocated
  390. allocateexpandedmemorypages   - allocate requested number of pages and return a
  391.                 handle used to reference allocated pages
  392. mapexpandedmemorypages    - map one of the logical pages of EM assigned to a
  393.               handle onto one of the four physical pages within
  394.               the EMM page frame
  395. getpageframebaseaddress - return the segment address of the page frame used by the EMM
  396. deallocateexpandedmemorypages - deallocate the pages of EM currently assigned to a handle
  397. getversionnumber    - return the EMM version number in a string format
  398. gethandlecountused    - return the number of total handles used by all applications
  399. getpagesownedbyhandle    - return the number of EM pages allocated to a specific EMM handle
  400.  
  401. Ram Disk Driver
  402. ---------------
  403. emsopen         - open an EMS ram disk file
  404. emsseek         - move the current position of an EMS Ram file to
  405.               a specified byte component
  406. emsblockwrite        - write the information pointed to by the buffer
  407.               pointer to the EMS Ram file
  408. emsblockread        - read from the EMS Ram file to memory pointed to
  409.               by the buffer pointer
  410. emsclose        - close an open EMS Ram file
  411.  
  412. Virtual Disk Heap
  413. -----------------
  414. vdskopenheapfile    - open a heap file on disk
  415. vemsopenheapfile    - open a heap file in EMS
  416.  
  417. vdskgetmem        - allocate a block within the virtual heap memory
  418.               and return a virtual heap address
  419. vdskfreemem        - free the virtual heap memory pointed to by the
  420.               VDSK Heap Ptr
  421. vdskwriteheapdata    - write the data from memory pointed to by the Data
  422.               Ptr to an allocated virtual heap memory
  423. vdskreadheapdata    - read the data from the virtual heap memory to a
  424.               memory area pointed to by the Data Ptr
  425. vdskcloseheapfile    - close a virtual heap
  426.  
  427. Virtual Memory Manager
  428. ----------------------
  429. useharddisk        - force virtual memory manager to use the hard disk
  430.               as virtual memory, even if EMS is available
  431. movefromvirtual     - move a block of data from virtual back to normal memory
  432. movetovirtual        - move a block of data from memory to virtual memory
  433. freevirtual        - free the virtual memory back to the virtual memory pool for reuse
  434. cmaxavail        - return the size of the largest block available in the upper heap
  435. virtualmemused        - return the amount of virtual memory allocated
  436. reservehugeminimum    - partition the heap memory into lower and upper areas to reduce
  437.               fragmentation
  438.  
  439. Sizing and Sliding
  440. ------------------
  441. defineresizeclickarea    - set a mouse click area for resizing a frame
  442. defineresizeminmax    - set the minimum and maximum that a frame can be resized to
  443. definesliderarea    - define slider area
  444. dropsliders        - remove all sliders from a frame
  445. findsliderfs        - find a slider on a frame
  446. resizeframe        - allocate a new buffer for a frame
  447. selectandmoveframe    - event that allows the frame to be moved
  448. setslideposition    - move a slider to a new position
  449.  
  450. Miscellaneous
  451. -------------
  452. checkctrlbreak        - check task handler
  453. checkctrlbreakfs    - set an event to call when ctl-break is pressed
  454. droptimertick        - remove an event set with SetTimerTick
  455. nilunitproc        - place holder for events that have not been coded
  456. overlaparea        - return the area that is occupied by two sets of coordinates
  457. settimertick        - set an event to be called periodically
  458.  
  459.  
  460.  
  461.       Copyright ■ 1990 TEGL Systems Corporation.  All rights reserved.
  462.  Suite 780, 789 West Pender Street, Vancouver, B.C.  V6C 1H2  (604) 669-2577
  463.  
  464.  
  465.  
  466.